用户主页接口文档

页面路由: /[vanityUrl] (如 /neo) 相关组件: User Profile Page 创建时间: 2026-02-26

页面概述

用户主页是公开的个人/店铺展示页面，通过 vanity URL（如 neo）访问。该页面支持游客访问，展示用户的个人信息、店铺模块、商品、帖子等内容。

核心 API 请求

页面初始化并行请求

访问 https://release.pear.us/neo 时，会发起以下核心请求：

# Method Endpoint 说明
1 GET /user/vanity-url/${vanityUrl} 获取用户公开信息
2 GET /store-front/shop/${vanityUrl} 获取店铺模块配置
3 POST /user/browse-history 记录访问历史

详细 API 列表

用户信息相关

Method Endpoint 参数 说明
GET /user/vanity-url/${vanityUrl} vanityUrl 获取用户公开资料
GET /feature-flag/user/${userId} userId 获取用户功能开关（店主）
GET /feature-flag/user/${userId} userId 获取用户功能开关（访客）
POST /user/browse-history vanityUrl 记录访问历史

店铺内容相关

Method Endpoint 参数 说明
GET /promoter/collections/${vanityUrl}/shop vanityUrl 获取策展人集合列表
GET /promoter/product/${vanityUrl}/shop vanityUrl, scene, pageNumber, pageSize 获取店铺商品
GET /promoter/collections/public/${collectionVanityUrl}/products collectionVanityUrl, pageNumber, pageSize 获取指定集合商品
GET /posts/promoter/shop vanityUrl, pageSize, pageNumber, affiliateCode, scene 获取店铺帖子列表

自定义内容相关

Method Endpoint 参数 说明
GET /user-link/${userId}/list userId, pageSize, pageNumber 获取用户自定义链接
GET /user-contact-form/${userId}/list userId, pageSize, pageNumber 获取用户自定义表单

店主专属

Method Endpoint 参数 说明
GET /feature-setting/promoter/${settingId} settingId (如 CURATOR_SUBSCRIPTION) 获取推广者系统设置

前端代码位置

页面组件

文件路径 说明
apps/web/src/app/(pages)/[vanityUrl]/page.tsx 用户主页入口组件
apps/web/src/app/(pages)/curator/[vanityUrl]/page.tsx 策展人主页（增强版）

服务层

文件路径 说明
apps/web-common/services/user.ts 用户相关 API
apps/web-common/services/userModule.ts 店铺模块 API
apps/web-common/services/feature/flags/getUserFeatureFlags.ts 功能开关 API
apps/web-common/services/collection.ts 集合相关 API
apps/web-common/services/promoterProduct.ts 推广者商品 API
apps/web-common/services/promoter/post.ts 帖子和自定义内容 API

请求示例

获取用户信息

GET /user/vanity-url/neo

获取店铺商品（分页）

GET /promoter/product/neo/shop?pageNumber=1&pageSize=20

获取集合商品

GET /promoter/collections/public/winter-collection/products?pageNumber=1&pageSize=10

获取店铺帖子

GET /posts/promoter/shop?vanityUrl=neo&pageSize=10&pageNumber=1

记录访问历史

POST /user/browse-history
Content-Type: application/json

{
  "vanityUrl": "neo"
}

访问控制

[!info] 游客访问支持 所有 API 均支持游客访问（allowGuest: true 或特殊认证处理），确保用户主页可公开浏览。

相关文档

  • [[kat-collabs接口文档-20260226]] | 协作页面接口
  • [[API 分类索引]] | 所有 API 文档索引

results matching ""

    No results matching ""